home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / packet / p_aa4re / bbcopy3f / bbcopy.doc < prev    next >
Encoding:
Text File  |  1995-03-03  |  10.5 KB  |  263 lines
  1. ==============================================================================
  2. BBcopy.exe                        (c) 1993-1995 by Freeman. M. Crosby W1NPR
  3. Used  with  the  AA4RE BBS        (c) 1989-1995 by H. Roy Engehausen  AA4RE
  4.  
  5. ==============================================================================
  6. Description:
  7.  
  8. BBcopy.exe allows any user to create a distribution from your BBS by sending a
  9. single message to an address you select ( Default is BBcopy ) @ Yourbbs.
  10.  
  11. No configuration is needed as long as Parms.bb is available in your Default
  12. current  "BB" directory. If you path to BBcopy.exe in another directory make
  13. sure you use it when calling it up.
  14. ------------------------------------------------------------------------------
  15. Added feature ( REDIST CLONE )
  16.  
  17. BBcopy.exe V2.13E adds the Generic REDIST server commands to the many already
  18. available in BBcopy for greater compatibility.
  19.  
  20. These require the messages to be addressed to the server in one of 4 ways.
  21.  
  22.      Address                                To Flood              @Address
  23. LOCBBS@ThisBBS.#lan.hroute.             This BBS only             W1NPR
  24. LOCAL@ThisBBS.#lan.hroute.              Nearby BBSs / Lan etc.    SRQLAN
  25. REGION@ThisBBS.#lan.hroute.             State/Province/Etc.       FLBBS
  26. LOCBBS@ThisBBS.#lan.hroute.             Country the BBS is in     ALLUSA
  27.  
  28. All REDIST type messages will be (B)ulletins and addressed to ALL by default.
  29. To alter the TO address Enter the desired address at the beginning of the
  30. Subject/Title line prefixed with an # as in
  31. #USER Regular Subject of message
  32. This will cause the message to be addressed to USER@Address with the Subject
  33. as the remaining part of the title line.
  34. -----------------------------------------------------------------------------
  35. Setup for REDIST will require you to capture the messages needed using the
  36. following lines in Wakeup.bb
  37. ==/==/== +1 EXPORTK BBCOPY.IN > LOCBBS & ^ @ =* & N
  38. ==/==/== +1 EXPORTK BBCOPY.IN > LOCAL & ^ @ =* & N
  39. ==/==/== +1 EXPORTK BBCOPY.IN > REGION & ^ @ =* & N
  40. ==/==/== +1 EXPORTK BBCOPY.IN > NATION & ^ @ =* & N
  41. Also you will need to edit the BBcopy.reg ( Region ) file supplied to indicate
  42. local distribution areas.  This file should be in the "BB" default directory
  43. -------------------------------------------------------------------------------
  44. Several other OPTIONS are available as explained below.
  45.  
  46. BBcopy.exe is called by Wakeup.bb whenever you wish, hourly might be OK
  47. Here is an example.
  48.  
  49. ==/==/== +1 ES [QEKIZ] BBCOPY BBCOPY.EXE
  50.  
  51. =============================================================================
  52.  
  53. Results:
  54.  
  55. The Originating user's Subject etc. will follow in the reproduced messages.
  56. Both (P) & (T) messages will be produced, any not of this type will be sent
  57. (P), except using the Copy Bulletin to: option below and the REDIST type.
  58.  
  59. An optional ( Copied by BBcopy ) break line may be included, see options.
  60.  
  61. The default will be a modified originating R: header which may allow it to
  62. pass back through the system and the receiving station use the SR command.
  63. See options below for many alternate R: header configurations.
  64.  
  65. The Full text as well as the full Copy to: distribution list will be in the
  66. reproduced messages unless the Copy text to: option is used.
  67.  
  68. The message to BBcopy will be killed, a return message will be sent to the
  69. original user telling of the distribution, a BBcopy.log will be created for
  70. the sysop to import if desired. This log will be killed each time it's
  71. filesize reaches 10K if is not imported prior to that time.
  72. ============================================================================
  73.  
  74. Operation by the user:
  75.  
  76. The user will send a message to BBcopy@Yourcall and MUST include as the very
  77. last lines, after all text trailers ect. the following words exactly as the
  78. first words on a line as follows upper or lower case will work ":" is needed
  79.  
  80. Copy to:
  81.  
  82. Followed by the stations he wishes to receive the message, one to a line.
  83.  
  84. If complete addresses are available he should provide them although when REBBS
  85. does a normal Hlookup they should be addressed OK if the stations are in your
  86. Hlookup.bb file
  87.  
  88. An @BBS is a requirement even if the messages will be @Yourbbs
  89.  
  90. An example would be:
  91.  
  92. Copy to:
  93. W2TKU@W2TKU.#SRQFL.FL.USA.NA
  94. WD4NKZ@WD4NKZ.#SRQFL.FL.USA.NA
  95. W1TTY@KQ1K.#EMA.MA.USA.NA
  96. K4JVY@WD4NKZ.#SRQFL.FL.USA.NA
  97.  
  98. ==============================================================================
  99. If you use "Copy text to:" instead of Copy to: then only the text will be
  100. copied into the messages, otherwise the Copy to: list will also be sent.
  101. Example:
  102.  
  103. Copy text to:
  104. W2TKU@W2TKU.#SRQFL.FL.USA.NA
  105. WD4NKZ@WD4NKZ.#SRQFL.FL.USA.NA
  106. W1TTY@KQ1K.#EMA.MA.USA.NA
  107. K4JVY@WD4NKZ.#SRQFL.FL.USA.NA
  108.  
  109. ==============================================================================
  110.  
  111. If you use "Copy bulletin to:" instead of Copy to: then one (1) copy will be
  112. produced as a bulletin, the copy list will not be sent.
  113. Example:
  114.  
  115. Copy bulletin to:
  116. REBBS@USBBS
  117.  
  118. -------------
  119. Note, This will allow a user to send a bulletin for local distribution to
  120. a distant BBS as a (P) message so it will not be left & read at each BBS
  121. along the way.
  122.  
  123. NO options will be used with a Bulletin, it will receive the default R:header
  124. which will identify the original user/bbs and allow "SR" from most BBS systems
  125.  
  126. ==============================================================================
  127. Help file:
  128.  
  129. A coded in help file is sent with operating instructions if a message is
  130. sent to BBCOPY@YourBBS with a Subject "I" or "H" or "?" and has no Copy to:
  131. list.
  132.  
  133. A similar help file will be sent if the Copy to: list is blank & no copies
  134. are created.
  135.  
  136. If you have a Filename.ext called BBcopy.rep in your "BB" default directory
  137. it will be sent in place of the help file included in the BBcopy.exe code.
  138. I recomend this as long as you  EDIT IT !! to reflect the BBcopy operation
  139. you have set up. Some functions are NOT described in the built-in help file.
  140. It would be desirable to indicate the Valid Flood designators are for your
  141. BBS in the help file.
  142.  
  143. A sample BBcopy.rep is enclosed ( EDIT IT ! )
  144.  
  145.  
  146. ============================================================================
  147. Alternate operation:
  148.  
  149. BBcopy will look for BBcopy.cfg if Parms.bb does not reside in the Default.
  150. This should duplicate the following Parms.bb parameters.
  151.  
  152.         BB_SIGN       =
  153.         BB_ADDR       =
  154.         BB_HIER_ADDR  =
  155.  
  156. Also you may use this if you wish to use different information for BBcopy.exe.
  157.  
  158. ==============================================================================
  159. You may alter the address that BBcopy will look for by adding a suffix to the
  160. program name when calling it up. The suffix SYNTAX MUST BE EXACT, including
  161. spaces between the characters etc.
  162. An example of the address DUPLI@W1NPR you would call BBcopy as follows:
  163.  
  164. ES [QEKIZ] DUPLI BBCOPY.EXE / DUPLI
  165.  
  166. BBcopy will look for DUPLI.OUT and create DUPLI.IN when it runs.
  167.  
  168. If an alternate address/Filename is used make sure you Export to it properly
  169. when adding lines in Action.bb if the REDIST type server is to be used.
  170.  
  171. REBBS will not run BBcopy if there is no Export file if you use the [QEKIZ]
  172. parameters.
  173.  
  174. BBcopy will not run if there is no Export file in any case.
  175. ===============================================================================
  176.  
  177. R: Header OPTIONS on copies:
  178.  
  179. Several options may be used to alter R:headers produced, these will be in [ ]
  180. brackets after the Filename.ext and BEFORE any alternate / address.
  181. These may be mixed and matched to produce many combinations.
  182.  
  183. [A] will produce all headers exactly from original message ( see * below )
  184. [B] will place a Break line before any previous R: headers ( Copied by BBcopy )
  185. [O] will pass the original header as received.
  186. [M] will modify the original header by removing any #???? or $????? but pass
  187.     enough data to identify the originator and allow the SR command to function.
  188.     (*) If [M] is used with [A] the first originating header will be modified.
  189.  
  190. The default is a single modified header identifying the original BBS in which
  191. no options need be specified. Bulletins will all receive the default.
  192.  
  193. Examples:
  194. [BA] would produce all headers as received with a Break line
  195. [AMB] would produce all headers, break line and modify original.
  196. ===============================================================================
  197. Undocumented in User help is the "End copy:" command.
  198. The Copy to list may be placed anywhere in the message and the program will
  199. pick up Addresses until the folowing line appears.
  200. End copy:
  201. Either Copy text to: or Copy to: may be used in this configuration
  202.  
  203. An example would be:
  204.  
  205. Copy text to:
  206. W2TKU@W2TKU.#SRQFL.FL.USA.NA
  207. WD4NKZ@WD4NKZ.#SRQFL.FL.USA.NA
  208. W1TTY@KQ1K.#EMA.MA.USA.NA
  209. End copy:
  210. ===============================================================================
  211.  
  212. Alternate operation:
  213.  
  214. BBcopy may be run in DV or Windows using the BBwait.exe & BBrun.bat system by
  215. ExportK ing the needed messages to whatever Filename.in you wish and ImportE
  216. ing them from Filename.in
  217.  
  218. Examples:
  219.  
  220. ==/==/== +00:15 EXPORTK BBCOPY.IN > LOCBBS & ^ @ =* & N
  221. ==/==/== +00:15 EXPORTK BBCOPY.IN > LOCAL & ^ @ =* & N
  222. ==/==/== +00:15 EXPORTK BBCOPY.IN > REGION & ^ @ =* & N
  223. ==/==/== +00:15 EXPORTK BBCOPY.IN > NATION & ^ @ =* & N
  224. ==/==/== +00:15 EXPORTK BBCOPY.IN > BBCOPY & ^ @ =* & N
  225. ==/==/== +00:15 IMPORTE BBCOPY.OUT
  226.  
  227.  
  228.  
  229.  
  230. Many combinations of Filename/options may be made in this manner even when
  231. running BBcopy using Wakeup.bb  Be sure to select [OPTIONS] and / Filename
  232. properly when entering the line in Wakeup.bb.
  233.  
  234. Different R:header configurations may be done with each Filename you use.
  235. ==============================================================================
  236. Keeping certain users from using BBcopy:
  237. If you have had a bad experience from a user who might wish to spawn messages
  238. using BBcopy you should have his mail placed on hold or review using Action.bb
  239. This will prevent exports to BBcopy until you can review and either accept or
  240. reject the message.
  241.  
  242. If you wish to hold all this users mail then
  243. HOLD < USER
  244. or just BBcopy messages
  245. HOLD < USER & > BBCOPY
  246. See Action.doc  for more options.
  247. ============================================================================
  248.  
  249. Report bugs & comments to:
  250.  
  251. Oct. 1 to June 1 yearly
  252. W1NPR@W1NPR.#SRQFL.FL.USA.NA
  253. (813)474-2690     Voice line
  254. (813)475-9526     Data  line
  255.  
  256. June 15 to Sept 24 yearly
  257. W1NPR@W1NPR.#EMA.MA.USA.NA
  258. (508)362-3940     Voice line
  259. (508)362-8958     Data  line
  260.  
  261. 73/Free
  262. W1NPR
  263.